home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / wa_112.zip / SYSOP.TXT < prev    next >
Text File  |  1991-08-09  |  8KB  |  200 lines
  1.  
  2.                        WIZARD'S ARENA -- RELEASE 1.12
  3.                    (C) Copyright 1991 by Douglas Summers
  4.  
  5.                             SYSOP DOCUMENTATION
  6.  
  7.  
  8.     Thank you for trying out Wizard's Arena.
  9.  
  10.     The Wizard's Arena (hereinafter, WA) is a BBS door game, allowing a
  11.     number of players to wander around in a large maze-like area and fight
  12.     it out, using a wide variety of spells and a certain amount of
  13.     ironmongery.  Further details on the setting of the game -- and on
  14.     actual play -- can be found in the player's documentation.
  15.  
  16.  
  17.     SETTING UP
  18.     ----------
  19.  
  20.     Check your distribution files.  You should have the following :
  21.  
  22.     WIZARD.EXE     -- the game itself
  23.     REGISTER.TXT   -- a description of the benefits of registering
  24.     WIZARD.TXT     -- the player documentation
  25.     COMMAND.TXT    -- the on-line quick-help file
  26.     CHANGES.TXT    -- a list of the modifications to the game since 1.00
  27.     SYSOP.TXT      -- this documentation
  28.     COPYRIGHT.TXT  -- the copyright notice for the game, and legal stuff
  29.     WA0000.*       -- the initial game database
  30.     GENERIC.SYS    -- used to run in LOCAL mode
  31.  
  32.     There may also be a README.TXT.  If one exists, you should read
  33.     it IMMEDIATELY.  If there isn't one, don't worry about it.  There
  34.     may also be an ADS.TXT file, which will be a small file describing
  35.     other games you might be interested in.  If it's not there, don't
  36.     sweat it particularly, either.
  37.  
  38.     Make a directory somewhere, and put these files in it.  All the files
  39.     should remain in the same directory; the game depends on the
  40.     database being in the same directory it is (although that doesn't
  41.     have to be the CURRENT directory at the time the program is run).
  42.  
  43.     You will now need to set up a batch file for running the game.
  44.  
  45.  
  46.     SETTING UP THE BATCH FILE
  47.     -------------------------
  48.  
  49.     You'll need to make a batch file to call the program with.  The line
  50.     actually calls the game can look something like this:
  51.  
  52.         C:\WIZARD\WIZARD C:\PCB\PCBOARD.SYS [options]
  53.  
  54.     The directory the game is in doesn't need to be on your path;
  55.     of course, your batch file must be.
  56.  
  57.     The first parameter to the program is the location (full path-and-
  58.     filename) of the door-information file for your BBS.  Different BBS
  59.     types use different ones, so if you're not sure how to set this up,
  60.     just refer to your BBS documentation.
  61.  
  62.     The options are, well, optional;  in fact, they have no effect until
  63.     you register the game.  There is a seperate file describing them,
  64.     named REGISTER.TXT.
  65.  
  66.     You'll have to make sure that only 1 player can get in at a time.
  67.     The batch file  should look something like this (this example is for
  68.     PCBoard):
  69.  
  70.         IF EXIST pcboard.txt GOTO inuse                       (skip if in use)
  71.         COPY inuse.txt pcboard.txt          (pcb displays this after the door)
  72.         C:\WIZARD\WIZARD C:\PCB\PCBOARD.SYS
  73.         DEL pcboard.txt                                   (mark it unused now)
  74.          :inuse
  75.         board.bat            (crank the bbs back up, pcb displays pcboard.txt)
  76.  
  77.  
  78.     SETTING THE BBS NAME
  79.     --------------------
  80.  
  81.     You should run the game once before your users do.  This will allow
  82.     you to set up the BBS's name -- which is important for registration
  83.     purposes.  You can reset the name anytime, but doing so will de-
  84.     register you (if you've registered); the Registration Sequence you
  85.     paid for won't work unless the name matches the old one.
  86.  
  87.     Run the program with the -N option (you can omit your door-info
  88.     file parameter, if you wish).
  89.  
  90.         C:\WIZARD\WIZARD -N
  91.  
  92.     Then the game will prompt you for the name of your BBS.  Enter it,
  93.     and hit return.  Now you're ready!
  94.  
  95.  
  96.     RUNNING LOCALLY
  97.     ---------------
  98.  
  99.     The game can be run locally simply by calling it directly
  100.     with no parameters.  It'll prompt you for a user's name; any user
  101.     in the game is available to you.
  102.  
  103.  
  104.     REGISTERING
  105.     -----------
  106.  
  107.     Registering the game is pretty easy.  Just enter the game, run the
  108.     help command '?', and take the 'Registration Info' option.
  109.     It'll give you a sequence of numbers and some letters, called
  110.     the 'Key Sequence'.  It is based partly on the BBS name you set
  111.     up, so if you change the name of your board, you'll need to
  112.     contact me for re-registration.  Write this sequence down.  The
  113.     game will ask you if you have the Registration sequence, and
  114.     you (being truthful) will answer No.
  115.  
  116.     Simply drop me a letter, with the key sequence and $15 enclosed.
  117.     You must also include a phone number for your BBS; and any comments
  118.     you have about the game are more than welcome.
  119.  
  120.     After the post office has done in glacial best to lose the letter,
  121.     I will return to you (via a postcard) a similar sequence of
  122.     numbers and some letters (along with my eternal gratitude).  Just
  123.     go through the Help/Registration sequence again, this time answering
  124.     (truthfully, as always) Yes. Enter the code from the postcard.
  125.     If you get it right, nothing very obvious will happen -- but the
  126.     next player to enter the board    will be overjoyed to see that you
  127.     support a starving shareware artist.  And you'll have access to the
  128.     features described in REGISTER.TXT.
  129.  
  130.     The address to send your hard-earned cash and Key Sequence are:
  131.  
  132.                  Douglas Summers        (even though I like 'Rick' better)
  133.                  PO Box 671652
  134.                  Marietta, GA 30067-0028
  135.  
  136.  
  137.  
  138.     SYSOP FUNCTIONS
  139.     ---------------
  140.  
  141.     The author is ver much indebted to Rickie Belitz for his excellent
  142.     CKIT library for the nuts-and-bolts of door handling.  Since I don't
  143.     have the source-code to this shareware library, my ability to support
  144.     it is limited.  If any problems come up, though, I'l try.  I've culled
  145.     a small amount of documentation from his text files, to describe the
  146.     features that my program provides via his library.
  147.  
  148.     Certain functions are allowed to the sysop while the remote user is
  149.     running the door.
  150.  
  151.     These (as drawn from his documentation) are:
  152.  
  153.  
  154.         Function Key
  155.         ------------
  156.  
  157.             F5           Shell to DOS
  158.             F8           Return user to system
  159.             F9           Toggle display
  160.             F3           Toggle Printer         (PCBoard only)
  161.             F4           Toggle Bell            (PCBoard only)
  162.             F7           Toggle Caller Alarm (PCBoard Only)
  163.             Alt-H        Toggle status line
  164.             Alt-N        Toffle sysop on next
  165.             Alt-X        exit to DOS after call
  166.  
  167.  
  168.     CKIT further supports customized COM ports.  By putting an
  169.     additional parameter before the options, you can support
  170.     pretty much ANY bizarro com-port arrangement you might have.
  171.  
  172.     The format for this parameter must be PORT:aaa:i, where aaaa
  173.     is the base address and i is the interrupt.  For example,
  174.  
  175.  
  176.         C:\WIZARD\WIZARD C:\PCB\PCBOARD.SYS PORT:02F8:3
  177.  
  178.     sets the system to use a com-port whose base address is 02F8
  179.     and which uses IRQ 3.
  180.  
  181.     CKIT uses the same mechanism to support FOSSIL drivers.  The
  182.     format for the parameter is PORT:F:n, where n is the number
  183.     of the com-port to use the fossil driver on.
  184.  
  185.  
  186.     IF ERRORS OCCUR...
  187.     ------------------
  188.  
  189.     If an error should happen during game-play, the user will be
  190.     dumped back to the BBS and a file named ERRORS.OUT will contain
  191.     specific information about the error.
  192.  
  193.     Try fixing the obvious things -- low RAM, not enough handles,
  194.     and so on.  If these don't work, contact the author.  He'll
  195.     try to sort it out.
  196.  
  197.     After errors are resolved, you might want to delete (or at least
  198.     edit) the error-file.  The game doesn't even try.
  199.  
  200.